% author: Radek Jankiewicz
\section{Wielojęzykowość}
\label{sec:interface:multilingual}

	\subparagraph{}
	LinguaPlone jest szeroko wykorzystywanym modułem systemu Plone umożliwiającym
	tworzenie treści w wielu językach, oraz wygodne zarządzanie nią, ponieważ jest
	on całkowicie zintegrowany z Plonem.
	\subparagraph{}
	Zasada działania wielojęzykowości polega na tworzeniu wersji językowych
	tłumaczonych obiektów. Wersje językowe danego obiektu są ze sobą powiązane,
	dzięki czemu można łatwo pomiędzy nimi przechodzić. Podstawowa wersja obiektu
	utworzona w danym języku nazywana jest wersją kanoniczną, z niej tworzone są
	pozostałe wersje językowe. Podczas dokonywania tłumaczenia użytkownik widzi
	oryginalną zawartość tłumaczonych pól wersji kanonicznej. Można również
	zdefiniować pola nie podlegające tłumczeniom, które podczas tłumaczenia będą
	przyjmowały wartość z wersji kanonicznej obiektu. Wersja językowa wyświetlana
	jest tylko podczas przeglądania strony w danym języku, ponadto jest ona
	niezależnym obiektem, który może być edytowany, lub usunięty (nie należy
	jednak usuwać wersji kanonicznych obiektów). Możliwe jest też tworzenie
	obiektów w języku neutralnym, bedą one wówczas widoczne niezależnie od języka,
	w którym przeglądana jest strona.
	
\section{Ustawienia językowe}
\label{sec:interface:portal_language_settings}

	\subparagraph{}
	Użytkownik posiadający rolę Zarządzającego może wybrać języki, na które
	będzie można tłumczyć treść portalu, oraz język domyślny. W tym celu należy w
	ustawieniach witryny przejść do ustawień języka (Rys.
	\ref{multilingual-settings} s. \pageref{multilingual-settings})
	
	\begin{figure}
    	\includegraphics[width=15cm]{images/multilingual-settings.png}
    	\caption{Ustawienia językowe}
    	\label{multilingual-settings}
    \end{figure}

	Jeżeli wybrany jest więcej niż jeden język, to w prawym rogu ekranu
	wyświetlany jest pasek zawierający flagi (Rys. \ref{multilingual-language-selection} s.
	\pageref{multilingual-language-selection})  dostępnych języków. Klikając we flagę można
	zmienić język, w którym przeglądany jest portal. Aktualnie wybrany język
	oznaczony jest pomarańczową ramką. W wybranym języku wyświetlane są tylko
	obiekty posiadające daną wersję językową lub obiekty istniejące w języku
	neutralnym.
	
	\begin{figure}
    	\includegraphics[width=15cm]{images/multilingual-language-selection.png}
    	\caption{Lista wyboru języka}
    	\label{multilingual-language-selection}
    \end{figure}

\section{Tłumaczenie obiektu}
\label{sec:interface:object_translation}

	\subparagraph{}
	Żeby utworzyć wersję językową obiektu należy wybrać dany język z listy
	\emph{Tłumacz na \ldots} znajdując się w kontekście danego obiektu (Rys.
	\ref{multilingual-translate-into} s. \pageref{multilingual-translate-into}).
	Po wybraniu języka przechodzi się do ekranu tłumaczenia obiektu, zmienia się
	też język, w którym przeglądany jest portal na język tworzonego tłumaczenia.
	
    \begin{figure}
    	\includegraphics[width=15cm]{images/multilingual-translate-into.png}
    	\caption{Tłumaczenie obiektu - lista wyboru języków}
    	\label{multilingual-translate-into}
    \end{figure}

    Podczas tworzenia tłumaczenia po lewej stronie widoczna jest zawartość
    tłumaczonych pól wersji kanonicznej (Rys. \ref{multilingual-translating}
    s. \pageref{multilingual-translating}). Po odpowiednim wypełnieniu pól
    należy zapisać tworzony obiekt. Należy pamiętać, że nowo utworzona wersja
    językowa nie jest domyślnie opublikowana. Może być ona niezależnie
    edytowana a nawet usunięta, jednak usunięcie wersji kanonicznej spowoduje,
    że zgubione zostanie powiązanie pomiędzy wszystkimi wersjami językowymi danego
    obiektu.
    
    \begin{figure}
    	\includegraphics[width=15cm]{images/multilingual-translating.png}
    	\caption{Tłumaczenie obiektu - formularz tłumaczenia}
    	\label{multilingual-translating}
    \end{figure}

\section{Zarządzanie tłumaczeniami}
\label{sec:interface:managing_translation}

	\subparagraph{}
	Żeby przejść do ekranu zarządzania tłumaczeniami danego obiektu należy z listy
	\emph{Tłumacz na \ldots} (Rys. \ref{multilingual-translate-into} s.
	\pageref{multilingual-translate-into}) wybrać link \emph{Zarządzaj
	tłuamczeniami \ldots}. Wyświetlony zostanie ekran zarządzania tłumaczeniami
	składający się z trzech sekcji (Rys. \ref{multilingual-managing-translation}
	s. \pageref{multilingual-managing-translation}):
	
	\begin{itemize}
      \item \emph{Zmień język treści} - umożliwia zmianę języka dla danego
      obiektu. Lista wyboru zawiera języki, na które obiekt nie został jeszcze
      przetłumaczony oraz język neutralny.
      \item \emph{Połącz tłumaczenia} - umożliwia przyłączenie obiektu
      wybranego za pomocą przeglądarki jako wersji językowej aktualnego
      obiektu. Należy pamiętać, że jeżeli aktualny obiekt nie jest obiektem
      kanonocznym, to można utracić jego pozostałe powiązania językowe.
      \item \emph{Usuń tłumaczenia} - umożliwia usunięcie wybranej
      istniejącej wersji językowej, lub połączenia z nią.
    \end{itemize}
	
	\begin{figure}
    	\includegraphics[width=15cm]{images/multilingual-managing-translation.png}
    	\caption{Zarządzanie tłumaczeniami}
    	\label{multilingual-managing-translation}
    \end{figure}

\section{Tłumaczenie folderów}
\label{sec:interface:folder_translating}

	\subparagraph{}
	Tłumaczenie folderów odbywa się na tej samej zasadzie co tłumaczenie innych
	obiektów. Należy jednak wspomnieć o zawartości folderów. W sytuacji gdy dany
	folder nie posiada swojej wersji językowej w danym języku to obiekty w nim
	zawarte przetłumaczone na dany język również będą się w nim zawierały.
	Natomiast po dokonaniu tłumaczenia folderu przenoszone są do niego wszystkie
	obiekty w danym języku. Tak więc, jeżeli folder będzie przetłumaczony na
	wszystkie dostępne języki, to każda jego wersja językowa będzie zawierała
	tylko obiekty w swoim języku.
